lesshint

lesshint

lesshint is a tool to aid you in writing clean and consistent Less.

• Requirements
• Installation
• Configuration
• Known issues

Important information

This is the final project for a associate degree, because of this pull requests cannot be accepted until mid-June 2015.

However, I (jwilsson) will need your help to decide which options that should be available for each linter and which option that should be the default value. For each linter that I add, I'll open a corresponding issue where a discussion/vote will take place for which options that should be included and which one should be the default. Therefore, I highly recommend users of this tool to not trust the defaults until a 1.0 release since some default values will change. In short, be extremely specific about which options you specify, don't trust the defaults just yet.

Please feel free to submit bug reports and other forms of feedback. That's greatly appreciated!

Requirements

• Node.js 0.10 or later
• io.js 1.0 or later

Installation

Run the following command from the command line (add -g to install globally):

npm install lesshint

Configuration

lesshint is customizable and we highly recommend you to look at the available options to tailor it to your needs.

Start by creating a .lesshintrc file in your project root and add your settings to it. It will be automatically loaded and merged with the default values.

Each option is then specifed by it's own JSON object, for example:

"spaceAfterPropertyColon": {
    "enabled": true,
    "style": "one_space" // Comments are allowed
}

If you're running lesshint from the command line, the -c or --config flags can be used to load any valid configuration file.

Known issues

We are aware of some instances where some Less features won't be properly parsed. In those cases the whole file will simply be ignored by lesshint.

• Not all forms of :extend() rules are supported. Related issue.
• Using variables in @media directives are not supported. Related issue.
• Passing Rulesets to Mixins, i.e. detached rulesets are not supported. Related issue.

Changelog

0.2.0 (2015-04-27)

• Added the following linters:
  • borderZero
  • hexLength
  • hexNotation
  • hexValidation
  • spaceAfterPropertyName
• lesshint will now exit with proper status codes. E.g. 1 when there's a lint error in a checked file, thus failing builds etc.
• Made some improvements to CLI output, added colors and made it easier to read.
• Fixed an issue where the spaceBeforeBrace linter would report the wrong column when style is one_space (#4).